package com.sky.skyopsserver.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.sky.skyopsserver.domain.HostGroup;
import com.sky.skyopsserver.vos.*;

import java.util.List;

/**
 * 主机组信息服务接口
 * 
 * @author Administrator
 * @description 针对表【host_group(主机组信息表)】的数据库操作Service
 * @createDate 2025-09-13 17:43:03
 */
public interface HostGroupService extends IService<HostGroup> {

    /**
     * 添加主机组
     * 
     * @param reqVO 添加主机组请求VO
     * @return 主机组ID
     */
    Long addHostGroup(HostGroupAddReqVO reqVO);

    /**
     * 更新主机组信息
     * 
     * @param reqVO 更新主机组请求VO
     * @return 是否更新成功
     */
    Boolean updateHostGroup(HostGroupUpdateReqVO reqVO);

    /**
     * 根据ID删除主机组
     * 
     * @param id 主机组ID
     * @return 是否删除成功
     */
    Boolean deleteHostGroup(Long id);

    /**
     * 批量删除主机组
     * 
     * @param ids 主机组ID列表
     * @return 是否删除成功
     */
    Boolean batchDeleteHostGroup(List<Long> ids);

    /**
     * 根据ID查询主机组详情
     * 
     * @param id 主机组ID
     * @return 主机组详情
     */
    HostGroupRspVO getHostGroupById(Long id);

    /**
     * 根据ID查询主机组详情（包含主机列表）
     * 
     * @param id 主机组ID
     * @return 主机组详情（包含主机列表）
     */
    HostGroupDetailRspVO getHostGroupDetailById(Long id);

    /**
     * 分页查询主机组列表
     * 
     * @param reqVO 分页查询请求VO
     * @return 分页结果
     */
    IPage<HostGroupRspVO> getHostGroupPage(HostGroupPageReqVO reqVO);

    /**
     * 查询所有主机组选项（用于下拉选择）
     * 
     * @return 主机组选项列表
     */
    List<HostGroupOptionRspVO> getAllHostGroupOptions();

    /**
     * 查询有主机的主机组选项
     * 
     * @return 主机组选项列表
     */
    List<HostGroupOptionRspVO> getHostGroupOptionsWithHosts();

    /**
     * 查询空主机组选项
     * 
     * @return 主机组选项列表
     */
    List<HostGroupOptionRspVO> getEmptyHostGroupOptions();

    /**
     * 获取主机组统计信息
     * 
     * @return 主机组统计信息
     */
    HostGroupStatisticsRspVO getHostGroupStatistics();

    /**
     * 检查主机组名称是否已存在
     * 
     * @param name 主机组名称
     * @param excludeId 排除的主机组ID（用于更新时检查）
     * @return 是否存在
     */
    Boolean checkHostGroupNameExists(String name, Long excludeId);

    /**
     * 根据名称模糊查询主机组
     * 
     * @param name 主机组名称关键字
     * @return 主机组列表
     */
    List<HostGroupRspVO> searchHostGroupByName(String name);

    /**
     * 移动主机到指定主机组
     * 
     * @param hostIds 主机ID列表
     * @param targetGroupId 目标主机组ID
     * @return 是否移动成功
     */
    Boolean moveHostsToGroup(List<Long> hostIds, Long targetGroupId);

    /**
     * 从主机组中移除主机
     * 
     * @param hostIds 主机ID列表
     * @param groupId 主机组ID
     * @return 是否移除成功
     */
    Boolean removeHostsFromGroup(List<Long> hostIds, Long groupId);

    /**
     * 获取主机组下的主机数量
     * 
     * @param groupId 主机组ID
     * @return 主机数量
     */
    Long getHostCountByGroupId(Long groupId);

    /**
     * 批量获取主机组下的主机数量
     * 
     * @param groupIds 主机组ID列表
     * @return 主机组ID与主机数量的映射
     */
    java.util.Map<Long, Long> getHostCountByGroupIds(List<Long> groupIds);
}
